package com.flying.flyingchessgame.mapper;

import com.flying.flyingchessgame.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Optional;

/**
 * 用户数据访问Mapper接口
 * <p>
 * 该接口定义了对用户表的各种数据库操作，包括查询、插入、更新等。
 * 具体的SQL语句在对应的XML映射文件中实现。
 * </p>
 * 
 * @author flying-chess
 * @version 1.0
 */
@Mapper
public interface UserMapper {
    
    /**
     * 通过ID查询用户
     *
     * @param id 用户ID
     * @return 用户对象，如果不存在则返回null
     */
    User findById(@Param("id") Long id);
    
    /**
     * 通过用户名查询用户
     *
     * @param username 用户名
     * @return 用户对象，如果不存在则返回null
     */
    User findByUsername(@Param("username") String username);
    
    /**
     * 通过邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户对象，如果不存在则返回null
     */
    User findByEmail(@Param("email") String email);
    
    /**
     * 检查用户名是否存在
     *
     * @param username 用户名
     * @return 如果存在返回true，否则返回false
     */
    boolean existsByUsername(@Param("username") String username);
    
    /**
     * 检查邮箱是否存在
     *
     * @param email 邮箱
     * @return 如果存在返回true，否则返回false
     */
    boolean existsByEmail(@Param("email") String email);
    
    /**
     * 插入新用户
     *
     * @param user 用户对象
     * @return 受影响的行数
     */
    int insert(User user);
    
    /**
     * 更新用户信息
     *
     * @param user 用户对象
     * @return 受影响的行数
     */
    int update(User user);
    
    /**
     * 删除用户
     *
     * @param id 用户ID
     * @return 受影响的行数
     */
    int deleteById(@Param("id") Long id);
} 